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Setting Path to Toolkit Executables (1) 


Navigation and Ancillary Information Facility 
Recommended for all Toolkits 
¢ Unix (OS X, Linux, BSD, execute the command echo $SHELL to 


determine your shell name) 


— csh, tesh: Use the set command to add the location of toolkit executables to 
your path. 
» set path = ($path /my directory/toolkit/exe) 


» set path = ($path /my directory/cspice/exe) 
» set path = ($path /my directory/icy/exe) 
» set path = ($path /my directory/mice/exe) 
— sh, bash, zsh, dash, ksh: Assign the $PATH environment variable. 
» PATH=$PATH:/my directory/toolkit/exe 
» PATH=$PATH:/my directory/cspice/exe 
» PATH=$PATH:/my_ directory/icy/exe 
» PATH=$PATH:/my directory/mice/exe 


Replace my directory with the path in which you installed the toolkit on your computer. 
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Setting Path to Toolkit Executables (2) 


Navigation and Ancillary Information Facility 


Recommended for all Toolkits 


¢ Windows 


— DOS shell: Use the set command to add the location of toolkit executables 
to your path. Use setx for a persistent setting. 
» set PATH=drive:\my directory\toolkit\exe ; tPATH% 
» set PATH=drive:\my directory\cspice\exe ; %PATH% 
» set PATH=drive:\my directory\icy\exe; %PATH% 
» set PATH=drive:\my_ directory\mice\exe; tPATH% 
— Or edit the environment variable PATH from the Advanced pane on the 
System Control Panel (Control Panel->System->Advanced). 


Replace drive: \my directory with the path in which you installed the toolkit on your 
computer. 
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Unix: Build a SPICE Executable 
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¢ Assume your Toolkit distribution is installed at: 
/naif/cspice/ for CSPICE (C toolkits) 
/naif/toolkit/ for SPICE (Fortran toolkits) 


¢ Compile and link an application-let’s pretend it’s named prgrm— 
against the CSPICE or SPICELIB library. 
— For C Linux/BSD/Unix: 
$ gcc prgrm.c -I/naif/cspice/include /naif/cspice/lib/cspice.a -1m 
— ForC OSX: 
$ clang prgrm.c -I/naif/cspice/include /naif/cspice/lib/cspice.a -lm 
— For FORTRAN: 
$ gfortran prgrm.f /naif/toolkit/spicelib.a 
¢ The default SPICE library names do not conform to the UNIX 
convention libname.a. So you cannot use the conventional 
library path/name options -Land-1, e.g. 
$ gcc .. -L/path_to_libs/ -lname 


unless you rename the SPICE library. 
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Windows: C compiler settings 
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¢ The standard installation of Microsoft Visual Studio may not 


update environment variables needed to use the C compiler (cl) 
from the standard DOS shell. 


— Visual Studio provides scripts to spawn a DOS shell with the needed 
environment. Find the scripts by navigating to the menu 


Programs -> Visual Studio “version” 


The script for a 64-bit C/C++ environment is: 


VSversion x64 Native Tools Command Prompt 


The script for a 64-bit ifort environment is: 


VSversion x86 Native Tools Command Prompt 
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Windows: ifort compiler settings 
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¢ The standard installation of Intel ifort may not update 
environment variables needed to use the Fortran compiler (ifort) 
from the standard DOS shell. 


— Intel provides batch scripts to spawn DOS shell with the needed 
environment. Find the scripts by navigating to the menu 


Programs -> Intel OneAPI 


The script for a 32-bit ifort environment is: 


Intel oneAPI command prompt for IA32 for Visual Studio 


The script for a 64-bit ifort environment is: 


Intel oneAPI command prompt for Intel 64 for Visual Studio 
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Windows: Build a SPICE Executable 


Navigation and Ancillary Information Facility 


¢ Assume the SPICE distribution is installed at: 


C:\naif\cspice\ for C toolkits 
C:\naif\toolkit\ for Fortran toolkits 


¢ Compile and link an application, say program, against the 
CSPICE or SPICELIB library. 
— For C toolkits: 


> el program.c -IC:\naif\cspice\include C:\naif\cspice\lib\cspice.lib 


— For FORTRAN toolkits: 


> ifort program.f C:\naif\toolkit\lib\SPICELIB.LIB 
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Icy: Register the Icy DLM to IDL (1) 
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Required for “Icy” 


e Unix and Windows 
— Use the IDL register command: 


IDL> dlm register, “ path_to_directory containing icy.d1m_’ 


e.g. 


IDL > dlm_register, ‘/naif/icy/lib/icy.dl1m’ 


— Or, copy icy.dlm and icy.so (or icy.dll) to IDL's binary directory located at 


{The IDL install directory}/bin/bin.user architecture, e.g. 


» For Unix, X86 architecture 


cp icy.dlm icy.so /Applications/exelis/idl/bin/bin.darwin.x86_ 64/ 


» For Windows, X86 architecture 


cp icy.dlm icy.dll C:\Program Files\Exelis\id183\bin\bin.x86 64\ 


continued on next page 
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Icy: Register the Icy DLM to IDL (2) 
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¢ Unix specific: 
— Start the IDL application from a shell in the directory containing both 
icy.dim and icy.so. 


— Append the path to your icy.dlm to the IDL_DLM_PATH environment 
variable to include the directory containing icy.dlm and icy.so, e.g.: 


setenv IDL _DLM PATH "<IDL_DEFAULT>: path_to directory containing icy.dlm_" 


Warning: do not invoke IDL from the Icy source directory, icy/src/icy, nor 
register that directory, and do not append that directory to 
IDL_DLM_PATH. This directory contains an “icy.dim” but not “icy.so.” 


continued on next page 
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Icy: Register the Icy DLM to IDL (3) 
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¢ Windows specific: 
— Set environment variable IDL_DLM_PATH from the Advanced pane 
of the System Control Panel. 
¢ Once registered as specified on earlier pages, confirm IDL 
recognizes and can access Icy. 
— Using the help command: 


IDL> help, ‘icy’, /DL 
**ICY - IDL/CSPICE interface from JPL/NAIF (not loaded) 


» Appearance of the words “not loaded” might suggest something is wrong, but 
this is expected state until you execute an Icy command. 


— Execute a trivial lcy command: 


IDL> print, cspice_ icy (‘version’) 
% Loaded DLM: ICY. 


Icy 1.4.20 25-DEC-2008 (EDW) 
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NAIE> Icy: Using the IDL IDE 
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Recommended for “Icy” 


¢ Use the IDL IDE’ s preferences panel to set the current working 
directory to the location where you will be developing your 
code. 


¢ Optional: Place your dim_ register command in a start up 


script. Specify the script using the IDL IDE’ s preferences panel. 
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Mice 
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Required for “Mice” 


Assume the Mice distribution is installed at c:\naif\mice\ on 
Windows, or /naif/mice/ on Unix/Linux. Use of Mice from Matlab 
requires the Mice source and library directories exist in the 


Matlab search path. The easiest way to update the Matlab path is 
with the “addpath” command. 


— On Windows: 


>> addpath ('C:\naif\mice\1lib') 
>> addpath('C:\naif\mice\src\mice') 


— On Unix/Linux: 


>> addpath ('/naif/mice/1lib') 
>> addpath ('/naif/mice/src/mice' ) 
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Backup 


¢ Icy programming example 

¢ Mice programming example 
¢ References 

Matlab 2016a MEX Change 
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Simple Icy Example 
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¢ As an example of Icy use with vectorization, calculate and plot 
the trajectory in the J2000 inertial frame of the Cassini 
spacecraft from June 20, 2004 to December 1, 2005. 


7; Construct a meta kernel, "Standard.tm”, which will be used to load the needed 
7; generic kernels: "naif0009.tls," "de421.bsp,” and "pck0009.tpc.” 


7; Load the generic kernels using the meta kernel, and a Cassini spk. 


cspice furnsh, 'standard.tm' 
cspice furnsh, '/kernels/cassini/spk/030201AP_ SK _SM546 _T45.bsp' 


7; Define the number of divisions of the time interval and the time interval. 
STEP = 10000 

utc = [ 'Jun 20, 2004', 'Dec 1, 2005' J 

espice str2et, utc, et 

times = dindgen(STEP) * (et[1]-et[0])/STEP + et[0] 


cspice spkpos, 'Cassini', times, 'J2000', 'NONE', 'SATURN BARYCENTER', pos, ltime 


; Plot the resulting trajectory. 


x = pos[0,*] 
y = pos[1,*] 
z = pos[2,*] 
iplot, xX, VY, Z 


cspice kclear 
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Graphic Output 
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“Px 70° 


Trajectory of the Cassini vehicle in the J2000 frame, for June 20, 2004 to Dec 1, 2005 
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Simple Mice Example 


Navigation and Ancillary Information Facility 


¢ As an example of Mice use with vectorization, calculate and 
plot the trajectory in the J2000 inertial frame of the Cassini 
spacecraft from June 20, 2004 to December 1, 2005 


% Construct a meta kernel, "Standard.tm”, which will be used to load the needed 
% generic kernels: "naif0009.tls," "de421.bsp,” and "pck0009.tpc.” 


% Load the generic kernels using the meta kernel, and a Cassini spk. 


cspice furnsh( { 'standard.tm', '/kernels/cassini/spk/030201AP SK _SM546_ T45.bsp'} ) 


% Define the number of divisions of the time interval and the time interval. 
STEP = 1000; 

et = cspice str2et( {'Jun 20, 2004', 'Dec 1, 2005'} ); 

times = (0:STEP-1) * ( et(2) - et(1) )/STEP + et(1); 


[pos, ltime]= cspice spkpos( 'Cassini', times, 'J2000', 'NONE', 'SATURN BARYCENTER' ); 


ole 


Plot the resulting trajectory. 


x = pos(1,:); 
y = pos(2,:); 
Z = pos(3,:);7 


plot3(x,y,Z) 


cspice kclear 
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Graphic Output 
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Trajectory of the Cassini vehicle in the J2000 frame, for June 20, 2004 to Dec 1, 2005 
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References 
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¢ NAIF documents providing more information 
concerning SPICE programing: 
— “icy.req,” Icy Required Reading 
» icy/doc/icy.req 
» icy/doc/html/req/icy.html 
— “mice.req,” Mice Required Reading 
» mice/doc/mice.req 
» mice/doc/html/req/mice.html 
— “cspice.req,” CSPICE Required Reading 
» cspice/doc/cspice.req 
» cspice/doc/html/req/cspice.html 
— “Introduction to the Family of SPICE Toolkits” tutorial 
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NAIE> Matlab 2016a MEX Change 
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¢ Mathworks changed the operation of the MEX 
utility in the Matlab 2016a. Use of the 
mkprodct.csh/mkprodct.bat build script included 
with SPICE Toolkit NO066 or earlier will fail to 
build Mice against 2016a or later. The N0067 
Toolkits include a modified version of the build 
scripts. 


Most Mice users should *NOT* rebuild the Mice 
Toolkit. 
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